@@ -1,4 +1,13 @@
Revision history for MooseX-POE
+
+0.207 2010-07-28
+ - Remove Module::Install::AutoInstall hackery entirely
+
+0.206 2010-07-27
+ - Avoid warnings with Moose 1.09 (Dave Rolsky)
+ - fix CHILD and PARENT methods (xsawyerx)
+ - various doc/example/test fixes (Avar, perigrin, Getty)
+
0.205 2009-06-26
- Fix inheritance of events (BinGOs)
- Add tests (BinGOs)
@@ -23,7 +23,9 @@ inc/Module/Install/Win32.pm
inc/Module/Install/WriteAll.pm
lib/MooseX/POE.pm
lib/MooseX/POE/Aliased.pm
+lib/MooseX/POE/Meta/Method/State.pm
lib/MooseX/POE/Meta/Role.pm
+lib/MooseX/POE/Meta/Trait.pm
lib/MooseX/POE/Meta/Trait/Class.pm
lib/MooseX/POE/Meta/Trait/Constructor.pm
lib/MooseX/POE/Meta/Trait/Instance.pm
@@ -34,6 +36,7 @@ lib/MooseX/POE/SweetArgs.pm
Makefile.PL
MANIFEST This list of files
META.yml
+README.md
t/01_basic.t
t/02_poe_forkbomb.t
t/03_extend.t
@@ -46,3 +49,8 @@ t/07_aliased.t
t/08_moosex_declare.t
t/09_extend.t
t/10_immutability.t
+t/11_regular_moose.t
+t/12_more_roles.t
+t/13_method_modifiers.t
+t/14_bug_double_build.t
+t/14_meh.t
@@ -4,11 +4,11 @@ author:
- 'Chris Prather C<< <chris@prather.org> >>'
build_requires:
ExtUtils::MakeMaker: 6.42
- Test::More: 0.42
+ Test::More: 0.90
configure_requires:
ExtUtils::MakeMaker: 6.42
distribution_type: module
-generated_by: 'Module::Install version 0.91'
+generated_by: 'Module::Install version 1.00'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
@@ -20,11 +20,9 @@ no_index:
- inc
- t
requires:
- Moose: 0.73
- MooseX::Async: 0.07
+ Moose: 0.90
POE: 1.004
- Sub::Name: 0.04
resources:
license: http://dev.perl.org/licenses/
repository: git://github.com/perigrin/moosex-poe.git
-version: 0.205
+version: 0.207
@@ -6,12 +6,10 @@ name 'MooseX-POE';
all_from 'lib/MooseX/POE.pm';
# Specific dependencies
-requires 'Moose' => '0.73';
-requires 'MooseX::Async' => '0.07';
+requires 'Moose' => '0.90';
requires 'POE' => '1.004';
-requires 'Sub::Name' => '0.04';
-build_requires 'Test::More' => '0.42';
+build_requires 'Test::More' => '0.90';
no_index 'directory' => 'ex';
@@ -0,0 +1,177 @@
+# NAME
+
+MooseX::POE - The Illicit Love Child of Moose and POE
+
+# VERSION
+
+This document describes MooseX::POE version 0.205
+
+# SYNOPSIS
+
+ package Counter;
+ use MooseX::POE;
+
+ has count => (
+ isa => 'Int',
+ is => 'rw',
+ lazy => 1,
+ default => sub { 0 },
+ );
+
+ sub START {
+ my ($self) = @_;
+ $self->yield('increment');
+ }
+
+ event increment => sub {
+ my ($self) = @_;
+ print "Count is now " . $self->count . "\n";
+ $self->count( $self->count + 1 );
+ $self->yield('increment') unless $self->count > 3;
+ };
+
+ no MooseX::POE;
+
+ Counter->new();
+ POE::Kernel->run();
+
+or with L<MooseX::Declare|MooseX::Declare>:
+
+ class Counter {
+ use MooseX::POE::SweetArgs qw(event);
+
+
+ has count => (
+ isa => 'Int',
+ is => 'rw',
+ lazy => 1,
+ default => sub { 0 },
+ );
+
+
+ sub START {
+ my ($self) = @_;
+ $self->yield('increment')
+ }
+
+
+ event increment => sub {
+ my ($self) = @_;
+ print "Count is now " . $self->count . "\n";
+ $self->count( $self->count + 1 );
+ $self->yield('increment') unless $self->count > 3;
+ }
+ }
+
+ Counter->new();
+ POE::Kernel->run();
+
+# DESCRIPTION
+
+MooseX::POE is a Moose wrapper around a POE::Session.
+
+# KEYWORDS
+
+- event $name $subref
+
+Create an event handler named $name.
+
+# METHODS
+
+Default POE-related methods are provided by L<MooseX::POE::Meta::Trait::Object|MooseX::POE::Meta::Trait::Object>
+which is applied to your base class (which is usually L<Moose::Object|Moose::Object>) when
+you use this module. See that module for the documentation for. Below is a list
+of methods on that class so you know what to look for:
+
+- get_session_id
+
+- yield
+
+- call
+
+- STARTALL
+
+- STOPALL
+
+
+
+# NOTES ON USAGE WITH L<MooseX::Declare|MooseX::Declare>
+
+L<MooseX::Declare|MooseX::Declare> support is still "experimental". Meaning that I don't use it,
+I don't have any code that uses it, and thus I can't adequately say that it
+won't cause monkeys to fly out of any orifices on your body beyond what the
+tests and the SYNOPSIS cover.
+
+That said there are a few caveats that have turned up during testing.
+
+1. The `method` keyword doesn't seem to work as expected. This is an
+integration issue that is being resolved but I want to wait for
+L<MooseX::Declare|MooseX::Declare> to gain some more polish on their slurpy
+arguments.
+
+2. MooseX::POE attempts to re-export L<Moose|Moose>, which
+L<MooseX::Declare|MooseX::Declare> has already exported in a custom fashion.
+This means that you'll get a keyword clash between the features that
+L<MooseX::Declare|MooseX::Declare> handles for you and the features that Moose
+handles. To work around this you'll need to write:
+
+ use MooseX::POE qw(event);
+ # or
+ use MooseX::POE::SweetArgs qw(event);
+ # or
+ use MooseX::POE::Role qw(event);
+
+to keep MooseX::POE from exporting the sugar that
+L<MooseX::Declare|MooseX::Declare> doesn't like. This is fixed in the Git
+version of L<MooseX::Declare|MooseX::Declare> but that version (as of this
+writing) is not on the CPAN.
+
+# DEPENDENCIES
+
+L<Moose|Moose>
+
+L<POE|POE>
+
+# AUTHOR
+
+Chris Prather `<chris@prather.org>`
+
+Ash Berlin `<ash@cpan.org>`
+
+Chris Williams `<chris@bingosnet.co.uk`>
+
+Yuval (nothingmuch) Kogman
+
+# LICENCE AND COPYRIGHT
+
+Copyright (c) 2007-2009, Chris Prather `<chris@prather.org>`, Ash Berlin
+`<ash@cpan.org>`, Chris Williams `<chris@bingosnet.co.uk`>, Yuval
+(nothingmuch) Kogman. Some rights reserved.
+
+This module is free software; you can redistribute it and/or
+modify it under the same terms as Perl itself. See [perlartistic](http://search.cpan.org/perldoc?perlartistic).
+
+
+
+# DISCLAIMER OF WARRANTY
+
+BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
+EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
+ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
+YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
+NECESSARY SERVICING, REPAIR, OR CORRECTION.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE
+LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL,
+OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
+THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
\ No newline at end of file
@@ -98,7 +98,7 @@ sub signal_handler {
# This is the main part of the test. This state uses the yield()
# function to loop until certain conditions are met.
-my $max_sessions = 200;
+my $max_sessions = 800;
my $half_sessions = int($max_sessions / 2);
sub fork {
@@ -2,7 +2,7 @@
use strict;
my $count = 0;
-my $max_sessions = 30;
+my $max_sessions = 800;
my $half_sessions = int( $max_sessions / 2 );
my %english = (
@@ -4,7 +4,7 @@ package Module::Install::Base;
use strict 'vars';
use vars qw{$VERSION};
BEGIN {
- $VERSION = '0.91';
+ $VERSION = '1.00';
}
# Suspend handler for "redefined" warnings
@@ -51,13 +51,18 @@ sub admin {
#line 106
sub is_admin {
- $_[0]->admin->VERSION;
+ ! $_[0]->admin->isa('Module::Install::Base::FakeAdmin');
}
sub DESTROY {}
package Module::Install::Base::FakeAdmin;
+use vars qw{$VERSION};
+BEGIN {
+ $VERSION = $Module::Install::Base::VERSION;
+}
+
my $fake;
sub new {
@@ -75,4 +80,4 @@ BEGIN {
1;
-#line 154
+#line 159
@@ -9,7 +9,7 @@ use Module::Install::Base ();
use vars qw{$VERSION @ISA $ISCORE};
BEGIN {
- $VERSION = '0.91';
+ $VERSION = '1.00';
@ISA = 'Module::Install::Base';
$ISCORE = 1;
}
@@ -6,7 +6,7 @@ use Module::Install::Base ();
use vars qw{$VERSION @ISA $ISCORE};
BEGIN {
- $VERSION = '0.91';
+ $VERSION = '1.00';
@ISA = 'Module::Install::Base';
$ISCORE = 1;
}
@@ -4,10 +4,11 @@ package Module::Install::Makefile;
use strict 'vars';
use ExtUtils::MakeMaker ();
use Module::Install::Base ();
+use Fcntl qw/:flock :seek/;
use vars qw{$VERSION @ISA $ISCORE};
BEGIN {
- $VERSION = '0.91';
+ $VERSION = '1.00';
@ISA = 'Module::Install::Base';
$ISCORE = 1;
}
@@ -25,8 +26,8 @@ sub prompt {
die "Caught an potential prompt infinite loop ($c[1]|$c[2]|$_[0])";
}
- # In automated testing, always use defaults
- if ( $ENV{AUTOMATED_TESTING} and ! $ENV{PERL_MM_USE_DEFAULT} ) {
+ # In automated testing or non-interactive session, always use defaults
+ if ( ($ENV{AUTOMATED_TESTING} or -! -t STDIN) and ! $ENV{PERL_MM_USE_DEFAULT} ) {
local $ENV{PERL_MM_USE_DEFAULT} = 1;
goto &ExtUtils::MakeMaker::prompt;
} else {
@@ -34,21 +35,112 @@ sub prompt {
}
}
+# Store a cleaned up version of the MakeMaker version,
+# since we need to behave differently in a variety of
+# ways based on the MM version.
+my $makemaker = eval $ExtUtils::MakeMaker::VERSION;
+
+# If we are passed a param, do a "newer than" comparison.
+# Otherwise, just return the MakeMaker version.
+sub makemaker {
+ ( @_ < 2 or $makemaker >= eval($_[1]) ) ? $makemaker : 0
+}
+
+# Ripped from ExtUtils::MakeMaker 6.56, and slightly modified
+# as we only need to know here whether the attribute is an array
+# or a hash or something else (which may or may not be appendable).
+my %makemaker_argtype = (
+ C => 'ARRAY',
+ CONFIG => 'ARRAY',
+# CONFIGURE => 'CODE', # ignore
+ DIR => 'ARRAY',
+ DL_FUNCS => 'HASH',
+ DL_VARS => 'ARRAY',
+ EXCLUDE_EXT => 'ARRAY',
+ EXE_FILES => 'ARRAY',
+ FUNCLIST => 'ARRAY',
+ H => 'ARRAY',
+ IMPORTS => 'HASH',
+ INCLUDE_EXT => 'ARRAY',
+ LIBS => 'ARRAY', # ignore ''
+ MAN1PODS => 'HASH',
+ MAN3PODS => 'HASH',
+ META_ADD => 'HASH',
+ META_MERGE => 'HASH',
+ PL_FILES => 'HASH',
+ PM => 'HASH',
+ PMLIBDIRS => 'ARRAY',
+ PMLIBPARENTDIRS => 'ARRAY',
+ PREREQ_PM => 'HASH',
+ CONFIGURE_REQUIRES => 'HASH',
+ SKIP => 'ARRAY',
+ TYPEMAPS => 'ARRAY',
+ XS => 'HASH',
+# VERSION => ['version',''], # ignore
+# _KEEP_AFTER_FLUSH => '',
+
+ clean => 'HASH',
+ depend => 'HASH',
+ dist => 'HASH',
+ dynamic_lib=> 'HASH',
+ linkext => 'HASH',
+ macro => 'HASH',
+ postamble => 'HASH',
+ realclean => 'HASH',
+ test => 'HASH',
+ tool_autosplit => 'HASH',
+
+ # special cases where you can use makemaker_append
+ CCFLAGS => 'APPENDABLE',
+ DEFINE => 'APPENDABLE',
+ INC => 'APPENDABLE',
+ LDDLFLAGS => 'APPENDABLE',
+ LDFROM => 'APPENDABLE',
+);
+
sub makemaker_args {
- my $self = shift;
+ my ($self, %new_args) = @_;
my $args = ( $self->{makemaker_args} ||= {} );
- %$args = ( %$args, @_ );
+ foreach my $key (keys %new_args) {
+ if ($makemaker_argtype{$key}) {
+ if ($makemaker_argtype{$key} eq 'ARRAY') {
+ $args->{$key} = [] unless defined $args->{$key};
+ unless (ref $args->{$key} eq 'ARRAY') {
+ $args->{$key} = [$args->{$key}]
+ }
+ push @{$args->{$key}},
+ ref $new_args{$key} eq 'ARRAY'
+ ? @{$new_args{$key}}
+ : $new_args{$key};
+ }
+ elsif ($makemaker_argtype{$key} eq 'HASH') {
+ $args->{$key} = {} unless defined $args->{$key};
+ foreach my $skey (keys %{ $new_args{$key} }) {
+ $args->{$key}{$skey} = $new_args{$key}{$skey};
+ }
+ }
+ elsif ($makemaker_argtype{$key} eq 'APPENDABLE') {
+ $self->makemaker_append($key => $new_args{$key});
+ }
+ }
+ else {
+ if (defined $args->{$key}) {
+ warn qq{MakeMaker attribute "$key" is overriden; use "makemaker_append" to append values\n};
+ }
+ $args->{$key} = $new_args{$key};
+ }
+ }
return $args;
}
# For mm args that take multiple space-seperated args,
# append an argument to the current list.
sub makemaker_append {
- my $self = sShift;
+ my $self = shift;
my $name = shift;
my $args = $self->makemaker_args;
- $args->{name} = defined $args->{$name}
- ? join( ' ', $args->{name}, @_ )
+ $args->{$name} = defined $args->{$name}
+ ? join( ' ', $args->{$name}, @_ )
: join( ' ', @_ );
}
@@ -89,25 +181,22 @@ sub inc {
$self->makemaker_args( INC => shift );
}
-my %test_dir = ();
-
sub _wanted_t {
- /\.t$/ and -f $_ and $test_dir{$File::Find::dir} = 1;
}
sub tests_recursive {
my $self = shift;
- if ( $self->tests ) {
- die "tests_recursive will not work if tests are already defined";
- }
my $dir = shift || 't';
unless ( -d $dir ) {
die "tests_recursive dir '$dir' does not exist";
}
- %test_dir = ();
+ my %tests = map { $_ => 1 } split / /, ($self->tests || '');
require File::Find;
- File::Find::find( \&_wanted_t, $dir );
- $self->tests( join ' ', map { "$_/*.t" } sort keys %test_dir );
+ File::Find::find(
+ sub { /\.t$/ and -f $_ and $tests{"$File::Find::dir/*.t"} = 1 },
+ $dir
+ );
+ $self->tests( join ' ', sort keys %tests );
}
sub write {
@@ -130,12 +219,13 @@ sub write {
# an underscore, even though its own version may contain one!
# Hence the funny regexp to get rid of it. See RT #35800
# for details.
- $self->build_requires( 'ExtUtils::MakeMaker' => $ExtUtils::MakeMaker::VERSION =~ /^(\d+\.\d+)/ );
- $self->configure_requires( 'ExtUtils::MakeMaker' => $ExtUtils::MakeMaker::VERSION =~ /^(\d+\.\d+)/ );
+ my $v = $ExtUtils::MakeMaker::VERSION =~ /^(\d+\.\d+)/;
+ $self->build_requires( 'ExtUtils::MakeMaker' => $v );
+ $self->configure_requires( 'ExtUtils::MakeMaker' => $v );
} else {
# Allow legacy-compatibility with 5.005 by depending on the
# most recent EU:MM that supported 5.005.
- $self->build_requires( 'ExtUtils::MakeMaker' => 6.42 );
+ $self->build_requires( 'ExtUtils::MakeMaker' => 6.42 );
$self->configure_requires( 'ExtUtils::MakeMaker' => 6.42 );
}
@@ -143,59 +233,115 @@ sub write {
my $args = $self->makemaker_args;
$args->{DISTNAME} = $self->name;
$args->{NAME} = $self->module_name || $self->name;
- $args->{VERSION} = $self->version;
$args->{NAME} =~ s/-/::/g;
+ $args->{VERSION} = $self->version or die <<'EOT';
+ERROR: Can't determine distribution version. Please specify it
+explicitly via 'version' in Makefile.PL, or set a valid $VERSION
+in a module, and provide its file path via 'version_from' (or
+'all_from' if you prefer) in Makefile.PL.
+EOT
+
+ $DB::single = 1;
if ( $self->tests ) {
- $args->{test} = { TESTS => $self->tests };
+ my @tests = split ' ', $self->tests;
+ my %seen;
+ $args->{test} = {
+ TESTS => (join ' ', grep {!$seen{$_}++} @tests),
+ };
+ } elsif ( $Module::Install::ExtraTests::use_extratests ) {
+ # Module::Install::ExtraTests doesn't set $self->tests and does its own tests via harness.
+ # So, just ignore our xt tests here.
+ } elsif ( -d 'xt' and ($Module::Install::AUTHOR or $ENV{RELEASE_TESTING}) ) {
+ $args->{test} = {
+ TESTS => join( ' ', map { "$_/*.t" } grep { -d $_ } qw{ t xt } ),
+ };
}
if ( $] >= 5.005 ) {
$args->{ABSTRACT} = $self->abstract;
- $args->{AUTHOR} = $self->author;
+ $args->{AUTHOR} = join ', ', @{$self->author || []};
}
- if ( eval($ExtUtils::MakeMaker::VERSION) >= 6.10 ) {
- $args->{NO_META} = 1;
+ if ( $self->makemaker(6.10) ) {
+ $args->{NO_META} = 1;
+ #$args->{NO_MYMETA} = 1;
}
- if ( eval($ExtUtils::MakeMaker::VERSION) > 6.17 and $self->sign ) {
+ if ( $self->makemaker(6.17) and $self->sign ) {
$args->{SIGN} = 1;
}
unless ( $self->is_admin ) {
delete $args->{SIGN};
}
+ if ( $self->makemaker(6.31) and $self->license ) {
+ $args->{LICENSE} = $self->license;
+ }
- # Merge both kinds of requires into prereq_pm
my $prereq = ($args->{PREREQ_PM} ||= {});
%$prereq = ( %$prereq,
- map { @$_ }
+ map { @$_ } # flatten [module => version]
map { @$_ }
grep $_,
- ($self->configure_requires, $self->build_requires, $self->requires)
+ ($self->requires)
);
# Remove any reference to perl, PREREQ_PM doesn't support it
delete $args->{PREREQ_PM}->{perl};
- # merge both kinds of requires into prereq_pm
- my $subdirs = ($args->{DIR} ||= []);
+ # Merge both kinds of requires into BUILD_REQUIRES
+ my $build_prereq = ($args->{BUILD_REQUIRES} ||= {});
+ %$build_prereq = ( %$build_prereq,
+ map { @$_ } # flatten [module => version]
+ map { @$_ }
+ grep $_,
+ ($self->configure_requires, $self->build_requires)
+ );
+
+ # Remove any reference to perl, BUILD_REQUIRES doesn't support it
+ delete $args->{BUILD_REQUIRES}->{perl};
+
+ # Delete bundled dists from prereq_pm, add it to Makefile DIR
+ my $subdirs = ($args->{DIR} || []);
if ($self->bundles) {
+ my %processed;
foreach my $bundle (@{ $self->bundles }) {
- my ($file, $dir) = @$bundle;
- push @$subdirs, $dir if -d $dir;
- delete $prereq->{$file};
+ my ($mod_name, $dist_dir) = @$bundle;
+ delete $prereq->{$mod_name};
+ $dist_dir = File::Basename::basename($dist_dir); # dir for building this module
+ if (not exists $processed{$dist_dir}) {
+ if (-d $dist_dir) {
+ # List as sub-directory to be processed by make
+ push @$subdirs, $dist_dir;
+ }
+ # Else do nothing: the module is already present on the system
+ $processed{$dist_dir} = undef;
+ }
}
}
+ unless ( $self->makemaker('6.55_03') ) {
+ %$prereq = (%$prereq,%$build_prereq);
+ delete $args->{BUILD_REQUIRES};
+ }
+
if ( my $perl_version = $self->perl_version ) {
eval "use $perl_version; 1"
or die "ERROR: perl: Version $] is installed, "
. "but we need version >= $perl_version";
+
+ if ( $self->makemaker(6.48) ) {
+ $args->{MIN_PERL_VERSION} = $perl_version;
+ }
}
- $args->{INSTALLDIRS} = $self->installdirs;
+ if ($self->installdirs) {
+ warn qq{old INSTALLDIRS (probably set by makemaker_args) is overriden by installdirs\n} if $args->{INSTALLDIRS};
+ $args->{INSTALLDIRS} = $self->installdirs;
+ }
- my %args = map { ( $_ => $args->{$_} ) } grep {defined($args->{$_})} keys %$args;
+ my %args = map {
+ ( $_ => $args->{$_} ) } grep {defined($args->{$_} )
+ } keys %$args;
my $user_preop = delete $args{dist}->{PREOP};
- if (my $preop = $self->admin->preop($user_preop)) {
+ if ( my $preop = $self->admin->preop($user_preop) ) {
foreach my $key ( keys %$preop ) {
$args{dist}->{$key} = $preop->{$key};
}
@@ -219,9 +365,9 @@ sub fix_up_makefile {
. ($self->postamble || '');
local *MAKEFILE;
- open MAKEFILE, "< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
+ open MAKEFILE, "+< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
+ eval { flock MAKEFILE, LOCK_EX };
my $makefile = do { local $/; <MAKEFILE> };
- close MAKEFILE or die $!;
$makefile =~ s/\b(test_harness\(\$\(TEST_VERBOSE\), )/$1'inc', /;
$makefile =~ s/( -I\$\(INST_ARCHLIB\))/ -Iinc$1/g;
@@ -241,7 +387,8 @@ sub fix_up_makefile {
# XXX - This is currently unused; not sure if it breaks other MM-users
# $makefile =~ s/^pm_to_blib\s+:\s+/pm_to_blib :: /mg;
- open MAKEFILE, "> $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
+ seek MAKEFILE, 0, SEEK_SET;
+ truncate MAKEFILE, 0;
print MAKEFILE "$preamble$makefile$postamble" or die $!;
close MAKEFILE or die $!;
@@ -265,4 +412,4 @@ sub postamble {
__END__
-#line 394
+#line 541
@@ -6,7 +6,7 @@ use Module::Install::Base ();
use vars qw{$VERSION @ISA $ISCORE};
BEGIN {
- $VERSION = '0.91';
+ $VERSION = '1.00';
@ISA = 'Module::Install::Base';
$ISCORE = 1;
}
@@ -19,7 +19,6 @@ my @scalar_keys = qw{
name
module_name
abstract
- author
version
distribution_type
tests
@@ -43,8 +42,11 @@ my @resource_keys = qw{
my @array_keys = qw{
keywords
+ author
};
+*authors = \&author;
+
sub Meta { shift }
sub Meta_BooleanKeys { @boolean_keys }
sub Meta_ScalarKeys { @scalar_keys }
@@ -176,43 +178,6 @@ sub perl_version {
$self->{values}->{perl_version} = $version;
}
-#Stolen from M::B
-my %license_urls = (
- perl => 'http://dev.perl.org/licenses/',
- apache => 'http://apache.org/licenses/LICENSE-2.0',
- artistic => 'http://opensource.org/licenses/artistic-license.php',
- artistic_2 => 'http://opensource.org/licenses/artistic-license-2.0.php',
- lgpl => 'http://opensource.org/licenses/lgpl-license.php',
- lgpl2 => 'http://opensource.org/licenses/lgpl-2.1.php',
- lgpl3 => 'http://opensource.org/licenses/lgpl-3.0.html',
- bsd => 'http://opensource.org/licenses/bsd-license.php',
- gpl => 'http://opensource.org/licenses/gpl-license.php',
- gpl2 => 'http://opensource.org/licenses/gpl-2.0.php',
- gpl3 => 'http://opensource.org/licenses/gpl-3.0.html',
- mit => 'http://opensource.org/licenses/mit-license.php',
- mozilla => 'http://opensource.org/licenses/mozilla1.1.php',
- open_source => undef,
- unrestricted => undef,
- restrictive => undef,
- unknown => undef,
-);
-
-sub license {
- my $self = shift;
- return $self->{values}->{license} unless @_;
- my $license = shift or die(
- 'Did not provide a value to license()'
- );
- $self->{values}->{license} = $license;
-
- # Automatically fill in license URLs
- if ( $license_urls{$license} ) {
- $self->resources( license => $license_urls{$license} );
- }
-
- return 1;
-}
-
sub all_from {
my ( $self, $file ) = @_;
@@ -230,6 +195,8 @@ sub all_from {
die("The path '$file' does not exist, or is not a file");
}
+ $self->{values}{all_from} = $file;
+
# Some methods pull from POD instead of code.
# If there is a matching .pod, use that instead
my $pod = $file;
@@ -240,7 +207,7 @@ sub all_from {
$self->name_from($file) unless $self->name;
$self->version_from($file) unless $self->version;
$self->perl_version_from($file) unless $self->perl_version;
- $self->author_from($pod) unless $self->author;
+ $self->author_from($pod) unless @{$self->author || []};
$self->license_from($pod) unless $self->license;
$self->abstract_from($pod) unless $self->abstract;
@@ -350,6 +317,9 @@ sub version_from {
require ExtUtils::MM_Unix;
my ( $self, $file ) = @_;
$self->version( ExtUtils::MM_Unix->parse_version($file) );
+
+ # for version integrity check
+ $self->makemaker_args( VERSION_FROM => $file );
}
sub abstract_from {
@@ -360,7 +330,7 @@ sub abstract_from {
{ DISTNAME => $self->name },
'ExtUtils::MM_Unix'
)->parse_abstract($file)
- );
+ );
}
# Add both distribution and module name
@@ -385,11 +355,10 @@ sub name_from {
}
}
-sub perl_version_from {
- my $self = shift;
+sub _extract_perl_version {
if (
- Module::Install::_read($_[0]) =~ m/
- ^
+ $_[0] =~ m/
+ ^\s*
(?:use|require) \s*
v?
([\d_\.]+)
@@ -398,6 +367,16 @@ sub perl_version_from {
) {
my $perl_version = $1;
$perl_version =~ s{_}{}g;
+ return $perl_version;
+ } else {
+ return;
+ }
+}
+
+sub perl_version_from {
+ my $self = shift;
+ my $perl_version=_extract_perl_version(Module::Install::_read($_[0]));
+ if ($perl_version) {
$self->perl_version($perl_version);
} else {
warn "Cannot determine perl version info from $_[0]\n";
@@ -417,59 +396,164 @@ sub author_from {
([^\n]*)
/ixms) {
my $author = $1 || $2;
- $author =~ s{E<lt>}{<}g;
- $author =~ s{E<gt>}{>}g;
+
+ # XXX: ugly but should work anyway...
+ if (eval "require Pod::Escapes; 1") {
+ # Pod::Escapes has a mapping table.
+ # It's in core of perl >= 5.9.3, and should be installed
+ # as one of the Pod::Simple's prereqs, which is a prereq
+ # of Pod::Text 3.x (see also below).
+ $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> }
+ {
+ defined $2
+ ? chr($2)
+ : defined $Pod::Escapes::Name2character_number{$1}
+ ? chr($Pod::Escapes::Name2character_number{$1})
+ : do {
+ warn "Unknown escape: E<$1>";
+ "E<$1>";
+ };
+ }gex;
+ }
+ elsif (eval "require Pod::Text; 1" && $Pod::Text::VERSION < 3) {
+ # Pod::Text < 3.0 has yet another mapping table,
+ # though the table name of 2.x and 1.x are different.
+ # (1.x is in core of Perl < 5.6, 2.x is in core of
+ # Perl < 5.9.3)
+ my $mapping = ($Pod::Text::VERSION < 2)
+ ? \%Pod::Text::HTML_Escapes
+ : \%Pod::Text::ESCAPES;
+ $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> }
+ {
+ defined $2
+ ? chr($2)
+ : defined $mapping->{$1}
+ ? $mapping->{$1}
+ : do {
+ warn "Unknown escape: E<$1>";
+ "E<$1>";
+ };
+ }gex;
+ }
+ else {
+ $author =~ s{E<lt>}{<}g;
+ $author =~ s{E<gt>}{>}g;
+ }
$self->author($author);
} else {
warn "Cannot determine author info from $_[0]\n";
}
}
-sub license_from {
+#Stolen from M::B
+my %license_urls = (
+ perl => 'http://dev.perl.org/licenses/',
+ apache => 'http://apache.org/licenses/LICENSE-2.0',
+ apache_1_1 => 'http://apache.org/licenses/LICENSE-1.1',
+ artistic => 'http://opensource.org/licenses/artistic-license.php',
+ artistic_2 => 'http://opensource.org/licenses/artistic-license-2.0.php',
+ lgpl => 'http://opensource.org/licenses/lgpl-license.php',
+ lgpl2 => 'http://opensource.org/licenses/lgpl-2.1.php',
+ lgpl3 => 'http://opensource.org/licenses/lgpl-3.0.html',
+ bsd => 'http://opensource.org/licenses/bsd-license.php',
+ gpl => 'http://opensource.org/licenses/gpl-license.php',
+ gpl2 => 'http://opensource.org/licenses/gpl-2.0.php',
+ gpl3 => 'http://opensource.org/licenses/gpl-3.0.html',
+ mit => 'http://opensource.org/licenses/mit-license.php',
+ mozilla => 'http://opensource.org/licenses/mozilla1.1.php',
+ open_source => undef,
+ unrestricted => undef,
+ restrictive => undef,
+ unknown => undef,
+);
+
+sub license {
my $self = shift;
- if (
- Module::Install::_read($_[0]) =~ m/
- (
- =head \d \s+
- (?:licen[cs]e|licensing|copyright|legal)\b
- .*?
- )
- (=head\\d.*|=cut.*|)
- \z
- /ixms ) {
- my $license_text = $1;
- my @phrases = (
- 'under the same (?:terms|license) as (?:perl|the perl programming language) itself' => 'perl', 1,
- 'GNU general public license' => 'gpl', 1,
- 'GNU public license' => 'gpl', 1,
- 'GNU lesser general public license' => 'lgpl', 1,
- 'GNU lesser public license' => 'lgpl', 1,
- 'GNU library general public license' => 'lgpl', 1,
- 'GNU library public license' => 'lgpl', 1,
- 'BSD license' => 'bsd', 1,
- 'Artistic license' => 'artistic', 1,
- 'GPL' => 'gpl', 1,
- 'LGPL' => 'lgpl', 1,
- 'BSD' => 'bsd', 1,
- 'Artistic' => 'artistic', 1,
- 'MIT' => 'mit', 1,
- 'proprietary' => 'proprietary', 0,
- );
- while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) {
- $pattern =~ s{\s+}{\\s+}g;
- if ( $license_text =~ /\b$pattern\b/i ) {
- $self->license($license);
- return 1;
- }
+ return $self->{values}->{license} unless @_;
+ my $license = shift or die(
+ 'Did not provide a value to license()'
+ );
+ $license = __extract_license($license) || lc $license;
+ $self->{values}->{license} = $license;
+
+ # Automatically fill in license URLs
+ if ( $license_urls{$license} ) {
+ $self->resources( license => $license_urls{$license} );
+ }
+
+ return 1;
+}
+
+sub _extract_license {
+ my $pod = shift;
+ my $matched;
+ return __extract_license(
+ ($matched) = $pod =~ m/
+ (=head \d \s+ L(?i:ICEN[CS]E|ICENSING)\b.*?)
+ (=head \d.*|=cut.*|)\z
+ /xms
+ ) || __extract_license(
+ ($matched) = $pod =~ m/
+ (=head \d \s+ (?:C(?i:OPYRIGHTS?)|L(?i:EGAL))\b.*?)
+ (=head \d.*|=cut.*|)\z
+ /xms
+ );
+}
+
+sub __extract_license {
+ my $license_text = shift or return;
+ my @phrases = (
+ '(?:under )?the same (?:terms|license) as (?:perl|the perl (?:\d )?programming language)' => 'perl', 1,
+ '(?:under )?the terms of (?:perl|the perl programming language) itself' => 'perl', 1,
+ 'Artistic and GPL' => 'perl', 1,
+ 'GNU general public license' => 'gpl', 1,
+ 'GNU public license' => 'gpl', 1,
+ 'GNU lesser general public license' => 'lgpl', 1,
+ 'GNU lesser public license' => 'lgpl', 1,
+ 'GNU library general public license' => 'lgpl', 1,
+ 'GNU library public license' => 'lgpl', 1,
+ 'GNU Free Documentation license' => 'unrestricted', 1,
+ 'GNU Affero General Public License' => 'open_source', 1,
+ '(?:Free)?BSD license' => 'bsd', 1,
+ 'Artistic license' => 'artistic', 1,
+ 'Apache (?:Software )?license' => 'apache', 1,
+ 'GPL' => 'gpl', 1,
+ 'LGPL' => 'lgpl', 1,
+ 'BSD' => 'bsd', 1,
+ 'Artistic' => 'artistic', 1,
+ 'MIT' => 'mit', 1,
+ 'Mozilla Public License' => 'mozilla', 1,
+ 'Q Public License' => 'open_source', 1,
+ 'OpenSSL License' => 'unrestricted', 1,
+ 'SSLeay License' => 'unrestricted', 1,
+ 'zlib License' => 'open_source', 1,
+ 'proprietary' => 'proprietary', 0,
+ );
+ while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) {
+ $pattern =~ s#\s+#\\s+#gs;
+ if ( $license_text =~ /\b$pattern\b/i ) {
+ return $license;
}
}
+ return '';
+}
- warn "Cannot determine license info from $_[0]\n";
- return 'unknown';
+sub license_from {
+ my $self = shift;
+ if (my $license=_extract_license(Module::Install::_read($_[0]))) {
+ $self->license($license);
+ } else {
+ warn "Cannot determine license info from $_[0]\n";
+ return 'unknown';
+ }
}
sub _extract_bugtracker {
- my @links = $_[0] =~ m#L<(\Qhttp://rt.cpan.org/\E[^>]+)>#g;
+ my @links = $_[0] =~ m#L<(
+ \Qhttp://rt.cpan.org/\E[^>]+|
+ \Qhttp://github.com/\E[\w_]+/[\w_]+/issues|
+ \Qhttp://code.google.com/p/\E[\w_\-]+/issues/list
+ )>#gx;
my %links;
@links{@links}=();
@links=keys %links;
@@ -485,7 +569,7 @@ sub bugtracker_from {
return 0;
}
if ( @links > 1 ) {
- warn "Found more than on rt.cpan.org link in $_[0]\n";
+ warn "Found more than one bugtracker link in $_[0]\n";
return 0;
}
@@ -532,8 +616,15 @@ sub _perl_version {
return $v;
}
-
-
+sub add_metadata {
+ my $self = shift;
+ my %hash = @_;
+ for my $key (keys %hash) {
+ warn "add_metadata: $key is not prefixed with 'x_'.\n" .
+ "Use appopriate function to add non-private metadata.\n" unless $key =~ /^x_/;
+ $self->{values}->{$key} = $hash{$key};
+ }
+}
######################################################################
@@ -4,7 +4,7 @@ package Module::Install::Repository;
use strict;
use 5.005;
use vars qw($VERSION);
-$VERSION = '0.05';
+$VERSION = '0.06';
use base qw(Module::Install::Base);
@@ -6,7 +6,7 @@ use Module::Install::Base ();
use vars qw{$VERSION @ISA $ISCORE};
BEGIN {
- $VERSION = '0.91';
+ $VERSION = '1.00';
@ISA = 'Module::Install::Base';
$ISCORE = 1;
}
@@ -6,7 +6,7 @@ use Module::Install::Base ();
use vars qw{$VERSION @ISA $ISCORE};
BEGIN {
- $VERSION = '0.91';;
+ $VERSION = '1.00';
@ISA = qw{Module::Install::Base};
$ISCORE = 1;
}
@@ -26,7 +26,10 @@ sub WriteAll {
$self->check_nmake if $args{check_nmake};
unless ( $self->makemaker_args->{PL_FILES} ) {
- $self->makemaker_args( PL_FILES => {} );
+ # XXX: This still may be a bit over-defensive...
+ unless ($self->makemaker(6.25)) {
+ $self->makemaker_args( PL_FILES => {} ) if -f 'Build.PL';
+ }
}
# Until ExtUtils::MakeMaker support MYMETA.yml, make sure
@@ -19,6 +19,9 @@ package Module::Install;
use 5.005;
use strict 'vars';
+use Cwd ();
+use File::Find ();
+use File::Path ();
use vars qw{$VERSION $MAIN};
BEGIN {
@@ -28,7 +31,7 @@ BEGIN {
# This is not enforced yet, but will be some time in the next few
# releases once we can make sure it won't clash with custom
# Module::Install extensions.
- $VERSION = '0.91';
+ $VERSION = '1.00';
# Storage for the pseudo-singleton
$MAIN = undef;
@@ -38,18 +41,25 @@ BEGIN {
}
+sub import {
+ my $class = shift;
+ my $self = $class->new(@_);
+ my $who = $self->_caller;
-
-
-
-# Whether or not inc::Module::Install is actually loaded, the
-# $INC{inc/Module/Install.pm} is what will still get set as long as
-# the caller loaded module this in the documented manner.
-# If not set, the caller may NOT have loaded the bundled version, and thus
-# they may not have a MI version that works with the Makefile.PL. This would
-# result in false errors or unexpected behaviour. And we don't want that.
-my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm';
-unless ( $INC{$file} ) { die <<"END_DIE" }
+ #-------------------------------------------------------------
+ # all of the following checks should be included in import(),
+ # to allow "eval 'require Module::Install; 1' to test
+ # installation of Module::Install. (RT #51267)
+ #-------------------------------------------------------------
+
+ # Whether or not inc::Module::Install is actually loaded, the
+ # $INC{inc/Module/Install.pm} is what will still get set as long as
+ # the caller loaded module this in the documented manner.
+ # If not set, the caller may NOT have loaded the bundled version, and thus
+ # they may not have a MI version that works with the Makefile.PL. This would
+ # result in false errors or unexpected behaviour. And we don't want that.
+ my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm';
+ unless ( $INC{$file} ) { die <<"END_DIE" }
Please invoke ${\__PACKAGE__} with:
@@ -61,26 +71,28 @@ not:
END_DIE
-
-
-
-
-# If the script that is loading Module::Install is from the future,
-# then make will detect this and cause it to re-run over and over
-# again. This is bad. Rather than taking action to touch it (which
-# is unreliable on some platforms and requires write permissions)
-# for now we should catch this and refuse to run.
-if ( -f $0 ) {
- my $s = (stat($0))[9];
-
- # If the modification time is only slightly in the future,
- # sleep briefly to remove the problem.
- my $a = $s - time;
- if ( $a > 0 and $a < 5 ) { sleep 5 }
-
- # Too far in the future, throw an error.
- my $t = time;
- if ( $s > $t ) { die <<"END_DIE" }
+ # This reportedly fixes a rare Win32 UTC file time issue, but
+ # as this is a non-cross-platform XS module not in the core,
+ # we shouldn't really depend on it. See RT #24194 for detail.
+ # (Also, this module only supports Perl 5.6 and above).
+ eval "use Win32::UTCFileTime" if $^O eq 'MSWin32' && $] >= 5.006;
+
+ # If the script that is loading Module::Install is from the future,
+ # then make will detect this and cause it to re-run over and over
+ # again. This is bad. Rather than taking action to touch it (which
+ # is unreliable on some platforms and requires write permissions)
+ # for now we should catch this and refuse to run.
+ if ( -f $0 ) {
+ my $s = (stat($0))[9];
+
+ # If the modification time is only slightly in the future,
+ # sleep briefly to remove the problem.
+ my $a = $s - time;
+ if ( $a > 0 and $a < 5 ) { sleep 5 }
+
+ # Too far in the future, throw an error.
+ my $t = time;
+ if ( $s > $t ) { die <<"END_DIE" }
Your installer $0 has a modification time in the future ($s > $t).
@@ -89,15 +101,12 @@ This is known to create infinite loops in make.
Please correct this, then run $0 again.
END_DIE
-}
-
-
-
+ }
-# Build.PL was formerly supported, but no longer is due to excessive
-# difficulty in implementing every single feature twice.
-if ( $0 =~ /Build.PL$/i ) { die <<"END_DIE" }
+ # Build.PL was formerly supported, but no longer is due to excessive
+ # difficulty in implementing every single feature twice.
+ if ( $0 =~ /Build.PL$/i ) { die <<"END_DIE" }
Module::Install no longer supports Build.PL.
@@ -107,23 +116,42 @@ Please remove all Build.PL files and only use the Makefile.PL installer.
END_DIE
+ #-------------------------------------------------------------
+ # To save some more typing in Module::Install installers, every...
+ # use inc::Module::Install
+ # ...also acts as an implicit use strict.
+ $^H |= strict::bits(qw(refs subs vars));
+ #-------------------------------------------------------------
+ unless ( -f $self->{file} ) {
+ foreach my $key (keys %INC) {
+ delete $INC{$key} if $key =~ /Module\/Install/;
+ }
-# To save some more typing in Module::Install installers, every...
-# use inc::Module::Install
-# ...also acts as an implicit use strict.
-$^H |= strict::bits(qw(refs subs vars));
-
+ local $^W;
+ require "$self->{path}/$self->{dispatch}.pm";
+ File::Path::mkpath("$self->{prefix}/$self->{author}");
+ $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self );
+ $self->{admin}->init;
+ @_ = ($class, _self => $self);
+ goto &{"$self->{name}::import"};
+ }
+ local $^W;
+ *{"${who}::AUTOLOAD"} = $self->autoload;
+ $self->preload;
+ # Unregister loader and worker packages so subdirs can use them again
+ delete $INC{'inc/Module/Install.pm'};
+ delete $INC{'Module/Install.pm'};
+ # Save to the singleton
+ $MAIN = $self;
-use Cwd ();
-use File::Find ();
-use File::Path ();
-use FindBin;
+ return 1;
+}
sub autoload {
my $self = shift;
@@ -136,7 +164,21 @@ sub autoload {
# Delegate back to parent dirs
goto &$code unless $cwd eq $pwd;
}
- $$sym =~ /([^:]+)$/ or die "Cannot autoload $who - $sym";
+ unless ($$sym =~ s/([^:]+)$//) {
+ # XXX: it looks like we can't retrieve the missing function
+ # via $$sym (usually $main::AUTOLOAD) in this case.
+ # I'm still wondering if we should slurp Makefile.PL to
+ # get some context or not ...
+ my ($package, $file, $line) = caller;
+ die <<"EOT";
+Unknown function is found at $file line $line.
+Execution of $file aborted due to runtime errors.
+
+If you're a contributor to a project, you may need to install
+some Module::Install extensions from CPAN (or other repository).
+If you're a user of a module, please contact the author.
+EOT
+ }
my $method = $1;
if ( uc($method) eq $method ) {
# Do nothing
@@ -152,33 +194,6 @@ sub autoload {
};
}
-sub import {
- my $class = shift;
- my $self = $class->new(@_);
- my $who = $self->_caller;
-
- unless ( -f $self->{file} ) {
- require "$self->{path}/$self->{dispatch}.pm";
- File::Path::mkpath("$self->{prefix}/$self->{author}");
- $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self );
- $self->{admin}->init;
- @_ = ($class, _self => $self);
- goto &{"$self->{name}::import"};
- }
-
- *{"${who}::AUTOLOAD"} = $self->autoload;
- $self->preload;
-
- # Unregister loader and worker packages so subdirs can use them again
- delete $INC{"$self->{file}"};
- delete $INC{"$self->{path}.pm"};
-
- # Save to the singleton
- $MAIN = $self;
-
- return 1;
-}
-
sub preload {
my $self = shift;
unless ( $self->{extensions} ) {
@@ -204,6 +219,7 @@ sub preload {
my $who = $self->_caller;
foreach my $name ( sort keys %seen ) {
+ local $^W;
*{"${who}::$name"} = sub {
${"${who}::AUTOLOAD"} = "${who}::$name";
goto &{"${who}::AUTOLOAD"};
@@ -214,12 +230,18 @@ sub preload {
sub new {
my ($class, %args) = @_;
+ delete $INC{'FindBin.pm'};
+ {
+ # to suppress the redefine warning
+ local $SIG{__WARN__} = sub {};
+ require FindBin;
+ }
+
# ignore the prefix on extension modules built from top level.
my $base_path = Cwd::abs_path($FindBin::Bin);
unless ( Cwd::abs_path(Cwd::cwd()) eq $base_path ) {
delete $args{prefix};
}
-
return $args{_self} if $args{_self};
$args{dispatch} ||= 'Admin';
@@ -272,8 +294,10 @@ END_DIE
sub load_extensions {
my ($self, $path, $top) = @_;
+ my $should_reload = 0;
unless ( grep { ! ref $_ and lc $_ eq lc $self->{prefix} } @INC ) {
unshift @INC, $self->{prefix};
+ $should_reload = 1;
}
foreach my $rv ( $self->find_extensions($path) ) {
@@ -281,12 +305,13 @@ sub load_extensions {
next if $self->{pathnames}{$pkg};
local $@;
- my $new = eval { require $file; $pkg->can('new') };
+ my $new = eval { local $^W; require $file; $pkg->can('new') };
unless ( $new ) {
warn $@ if $@;
next;
}
- $self->{pathnames}{$pkg} = delete $INC{$file};
+ $self->{pathnames}{$pkg} =
+ $should_reload ? delete $INC{$file} : $INC{$file};
push @{$self->{extensions}}, &{$new}($pkg, _top => $top );
}
@@ -348,17 +373,24 @@ sub _caller {
return $call;
}
+# Done in evals to avoid confusing Perl::MinimumVersion
+eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@;
sub _read {
local *FH;
- if ( $] >= 5.006 ) {
- open( FH, '<', $_[0] ) or die "open($_[0]): $!";
- } else {
- open( FH, "< $_[0]" ) or die "open($_[0]): $!";
- }
+ open( FH, '<', $_[0] ) or die "open($_[0]): $!";
+ my $string = do { local $/; <FH> };
+ close FH or die "close($_[0]): $!";
+ return $string;
+}
+END_NEW
+sub _read {
+ local *FH;
+ open( FH, "< $_[0]" ) or die "open($_[0]): $!";
my $string = do { local $/; <FH> };
close FH or die "close($_[0]): $!";
return $string;
}
+END_OLD
sub _readperl {
my $string = Module::Install::_read($_[0]);
@@ -379,18 +411,26 @@ sub _readpod {
return $string;
}
+# Done in evals to avoid confusing Perl::MinimumVersion
+eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@;
sub _write {
local *FH;
- if ( $] >= 5.006 ) {
- open( FH, '>', $_[0] ) or die "open($_[0]): $!";
- } else {
- open( FH, "> $_[0]" ) or die "open($_[0]): $!";
+ open( FH, '>', $_[0] ) or die "open($_[0]): $!";
+ foreach ( 1 .. $#_ ) {
+ print FH $_[$_] or die "print($_[0]): $!";
}
+ close FH or die "close($_[0]): $!";
+}
+END_NEW
+sub _write {
+ local *FH;
+ open( FH, "> $_[0]" ) or die "open($_[0]): $!";
foreach ( 1 .. $#_ ) {
print FH $_[$_] or die "print($_[0]): $!";
}
close FH or die "close($_[0]): $!";
}
+END_OLD
# _version is for processing module versions (eg, 1.03_05) not
# Perl versions (eg, 5.8.1).
@@ -427,4 +467,4 @@ sub _CLASS ($) {
1;
-# Copyright 2008 - 2009 Adam Kennedy.
+# Copyright 2008 - 2010 Adam Kennedy.
@@ -0,0 +1,9 @@
+package MooseX::POE::Meta::Method::State;
+use strict;
+use Moose;
+extends qw(Moose::Meta::Method);
+
+no Moose;
+1;
+__END__
+
@@ -1,20 +1,21 @@
package MooseX::POE::Meta::Role;
use Moose::Role;
-with qw(MooseX::Async::Meta::Trait);
+with qw(MooseX::POE::Meta::Trait);
around default_events => sub {
- my ($orig, $self) = @_;
+ my ( $orig, $self ) = @_;
my $events = $orig->($self);
push @$events, grep { s/^on_(\w+)/$1/; } $self->get_method_list;
return $events;
};
around get_state_method_name => sub {
- my ($orig, $self, $name ) = @_;
+ my ( $orig, $self, $name ) = @_;
return 'on_' . $name if $self->has_method( 'on_' . $name );
- return $orig->($self, $name);
+ return $orig->( $self, $name );
};
+
no Moose::Role;
1;
@@ -2,7 +2,7 @@ package MooseX::POE::Meta::Trait::Class;
use Moose::Role;
-with qw(MooseX::Async::Meta::Trait);
+with qw(MooseX::POE::Meta::Trait);
# TODO: subclass events to be a hashref that maps the event to the method
# so we can support on_ events
@@ -17,8 +17,9 @@ around default_events => sub {
around add_role => sub {
my ( $next, $self, $role ) = @_;
$next->( $self, $role );
+
if ( $role->meta->can('does_role')
- && $role->meta->does_role("MooseX::Async::Meta::Trait") ) {
+ && $role->meta->does_role("MooseX::POE::Meta::Trait") ) {
$self->add_event( $role->get_events );
}
};
@@ -31,7 +32,7 @@ around get_state_method_name => sub {
sub get_all_events {
my ($self) = @_;
- my $wanted_role = 'MooseX::Async::Meta::Trait';
+ my $wanted_role = 'MooseX::POE::Meta::Trait';
# This horrible grep can be removed once Moose gets more metacircular.
# Currently Moose::Meta::Class->meta isn't a MMC. It should be, and it
@@ -15,6 +15,8 @@ sub new {
$self->meta->get_all_events,
STARTALL => 'STARTALL',
_stop => 'STOPALL',
+ _child => 'CHILD',
+ _parent => 'PARENT',
},
],
args => [$self],
@@ -52,8 +54,10 @@ sub STOPALL {
}
}
-sub START { }
-sub STOP { }
+sub START { }
+sub STOP { }
+sub CHILD { }
+sub PARENT { }
# __PACKAGE__->meta->add_method( _stop => sub { POE::Kernel->call('STOP') } );
@@ -0,0 +1,46 @@
+package MooseX::POE::Meta::Trait;
+use Moose::Role;
+
+use MooseX::POE::Meta::Method::State;
+
+has events => (
+ reader => 'get_events',
+ traits => ['Array'],
+ isa => 'ArrayRef',
+ auto_deref => 1,
+ lazy_build => 1,
+ builder => 'default_events',
+ handles => { 'add_event' => ['push'] },
+);
+
+sub default_events {
+ return [];
+}
+
+sub get_state_method_name {
+ my ( $self, $name ) = @_;
+ return $name if $self->has_method($name);
+ return undef;
+}
+
+sub add_state_method {
+ my ( $self, $name, $method ) = @_;
+ if ( $self->has_method($name) ) {
+ my $full_name = $self->get_method($name)->fully_qualified_name;
+ confess
+"Cannot add a state method ($name) if a local method ($full_name) is already present";
+ }
+
+ $self->add_event($name);
+ $self->add_method( $name => $method );
+}
+
+after add_role => sub {
+ my ( $self, $role ) = @_;
+
+ if ( $role->isa("MooseX::POE::Meta::Role") ) {
+ $self->add_event( $role->get_events );
+ }
+};
+
+1;
@@ -1,40 +1,34 @@
package MooseX::POE::Role;
-
use MooseX::POE::Meta::Role;
use Moose::Exporter;
-sub event ($&) {
- my ( $class, $name, $method ) = @_;
- $class->meta->add_state_method( $name => $method );
-}
-
-Moose::Exporter->setup_import_methods(
- with_caller => [ qw/event/ ],
- also => 'Moose::Role'
+my ( $import, $unimport, $init_meta ) = Moose::Exporter->setup_import_methods(
+ with_caller => [qw(event)],
+ also => 'Moose::Role',
+ install => [qw(import unimport)],
+ role_metaroles => {
+ role => ['MooseX::POE::Meta::Role'],
+ },
);
sub init_meta {
- my ($class, %p) = @_;
+ my ( $class, %args ) = @_;
- my $for = $p{for_class};
+ my $for = $args{for_class};
+ eval qq{package $for; use POE; };
- eval qq{package $for; use POE; };
+ Moose::Role->init_meta( for_class => $for );
- my $meta;
- unless ($for->can('meta')) {
- $meta = Moose::Role->init_meta(for_class => $for);
- } else {
- $meta = $for->meta;
- }
+ goto $init_meta;
+}
- Moose::Util::MetaRole::apply_metaclass_roles(
- for_class => $p{for_class},
- metaclass_roles => ['MooseX::POE::Meta::Role']
- );
+sub event {
+ my ( $caller, $name, $method ) = @_;
+ my $class = Moose::Meta::Class->initialize($caller);
+ $class->add_state_method( $name => $method );
}
-no Moose::Role;
1;
__END__
@@ -13,9 +13,11 @@ sub init_meta {
my ($class, %args) = @_;
MooseX::POE->init_meta(%args);
- Moose::Util::MetaRole::apply_metaclass_roles(
- for_class => $args{for_class},
- metaclass_roles => [ 'MooseX::POE::Meta::Trait::SweetArgs' ],
+ Moose::Util::MetaRole::apply_metaroles(
+ for => $args{for_class},
+ class_metaroles => {
+ class => ['MooseX::POE::Meta::Trait::SweetArgs'],
+ },
);
}
@@ -1,13 +1,20 @@
package MooseX::POE;
-our $VERSION = '0.205';
+our $VERSION = '0.207';
use Moose ();
use Moose::Exporter;
-Moose::Exporter->setup_import_methods(
- with_caller => [qw(event)],
- also => 'Moose',
+my ( $import, $unimport, $init_meta ) = Moose::Exporter->setup_import_methods(
+ with_caller => [qw(event)],
+ also => 'Moose',
+ install => [qw(import unimport)],
+ class_metaroles => {
+ class => ['MooseX::POE::Meta::Trait::Class'],
+ constructor => ['MooseX::POE::Meta::Trait::Constructor'],
+ instance => ['MooseX::POE::Meta::Trait::Instance'],
+ },
+ base_class_roles => ['MooseX::POE::Meta::Trait::Object'],
);
sub init_meta {
@@ -18,17 +25,7 @@ sub init_meta {
Moose->init_meta( for_class => $for );
- Moose::Util::MetaRole::apply_metaclass_roles(
- for_class => $for,
- metaclass_roles => ['MooseX::POE::Meta::Trait::Class'],
- constructor_class_roles => ['MooseX::POE::Meta::Trait::Constructor'],
- instance_metaclass_roles => ['MooseX::POE::Meta::Trait::Instance'],
- );
-
- Moose::Util::MetaRole::apply_base_class_roles(
- for_class => $for,
- roles => ['MooseX::POE::Meta::Trait::Object']
- );
+ goto $init_meta;
}
sub event {
@@ -102,6 +99,9 @@ or with L<MooseX::Declare|MooseX::Declare>:
}
}
+ Counter->new();
+ POE::Kernel->run();
+
=head1 DESCRIPTION
MooseX::POE is a Moose wrapper around a POE::Session.
@@ -142,7 +142,7 @@ of methods on that class so you know what to look for:
L<MooseX::Declare|MooseX::Declare> support is still "experimental". Meaning that I don't use it,
I don't have any code that uses it, and thus I can't adequately say that it
-won't cause monkeys to fly out of any orafices on your body beyond what the
+won't cause monkeys to fly out of any orifices on your body beyond what the
tests and the SYNOPSIS cover.
That said there are a few caveats that have turned up during testing.
@@ -1,7 +1,7 @@
#!/usr/bin/env perl
use strict;
-use Test::More tests => 6;
+use Test::More tests => 7;
use Test::Moose;
{
@@ -10,7 +10,9 @@ use Test::Moose;
sub foo { ::pass('foo!')}
- event yarr => sub { ::pass("yarr!") }
+ event yarr => sub { ::pass("yarr!"); shift->yield('matey'); };
+ event matey => sub { ::pass("matey!") };
+
}
{
@@ -6,7 +6,6 @@ use Test::More tests => 2;
package mxpoe;
use MooseX::POE;
- use MooseX::AttributeHelpers;
use Test::More;
sub START {
@@ -0,0 +1,15 @@
+#!/usr/bin/env perl
+use strict;
+
+use Test::More tests => 1;
+
+{
+ package Foo;
+ use MooseX::POE;
+
+ package Bar;
+ use Moose;
+ has a => ( is => 'ro' );
+}
+
+ok(!exists %{ Bar->new( a => 1) }->{session_id}, 'no session_id');
@@ -0,0 +1,33 @@
+#!/usr/bin/perl
+use Test::More tests => 1;
+{
+ package Getty;
+ use Moose::Role;
+}
+
+{
+ package Pants;
+ use MooseX::POE::Role;
+
+ event 'wear' => sub {
+ ::pass("I AM BEING WORN!");
+ };
+}
+
+{
+ package Clocks;
+ use MooseX::POE;
+ with 'Pants', 'Getty';
+
+ sub bork {
+ my ($self) = @_;
+ ::pass('bork');
+ $self->yield('wear');
+ }
+}
+
+
+
+my $c = Clocks->new;
+$c->bork;
+POE::Kernel->run;
@@ -0,0 +1,46 @@
+#!/usr/bin/env perl
+use strict;
+use Test::More tests => 6;
+
+{
+
+ package Base;
+ use MooseX::POE;
+
+ sub START {
+ ::pass('Base Start');
+ }
+
+ event hello => sub {
+ ::pass('hello');
+ $_[KERNEL]->yield('goodbye');
+ };
+}
+{
+
+ package Extended;
+ use MooseX::POE;
+
+ extends 'Base';
+
+ sub START {
+ ::pass('Extended after Start');
+ $_[KERNEL]->yield( 'hello' => 'world' );
+ }
+
+ before 'hello' => sub {
+ ::is( $_[ARG0], 'world', 'before saw world' );
+ };
+
+ after 'hello' => sub {
+ ::is( $_[ARG0], 'world', 'after saw world' );
+ };
+
+ event goodbye => sub {
+ ::pass('goodbye');
+ };
+
+}
+
+my $foo = Extended->new();
+POE::Kernel->run();
@@ -0,0 +1,24 @@
+#!/usr/bin/perl
+
+use Test::More;
+
+my $cnt = 0;
+
+{
+ package Test::DoubleBuild::MXP;
+
+ use MooseX::POE;
+
+ sub BUILD {
+ $cnt++;
+ }
+}
+
+Test::DoubleBuild::MXP->new;
+
+TODO: {
+ local $TODO = 'fix this';
+ is($cnt, 1, 'BUILD called once');
+}
+
+done_testing();
\ No newline at end of file
@@ -0,0 +1,96 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More;
+use Test::Exception;
+
+use POE;
+
+my @reason;
+my @retval;
+
+{
+
+ package Foo;
+ use MooseX::POE;
+
+ sub START {
+ ::ok('Foo Start');
+ return 'create';
+ }
+
+ sub STOP {
+ ::ok('Foo Stop');
+ return 'lose';
+ }
+}
+
+{
+
+ package ImmutableFoo;
+ use MooseX::POE;
+
+ sub START {
+ ::ok('Immutale Foo Start');
+ return 'create';
+ }
+
+ sub STOP {
+ ::ok('Immutale Foo Stop');
+ return 'lose';
+ }
+
+ __PACKAGE__->meta->make_immutable( inline_constructor => 0 );
+}
+
+use Data::Dumper;
+POE::Session->create(
+ inline_states => {
+ _start => sub {
+ Foo->new();
+ },
+ _child => sub {
+ diag Dumper [ @_[ ARG0, ARG2 ] ];
+ push( @reason, $_[ARG0] );
+ push( @retval, $_[ARG2] );
+ },
+ }
+);
+
+$poe_kernel->run;
+TODO: {
+ local $TODO = 'fix this later';
+is( scalar(@reason), 2, "called two times" );
+
+is_deeply( $reason[0], 'create', "CHILD create was called" );
+is_deeply( $reason[1], 'lose', "CHILD lose was called" );
+is_deeply( $retval[0], 'create', "START return value is correct" );
+is_deeply( $retval[1], 'lose', "STOP return value is correct" );
+
+@reason = ();
+@retval = ();
+
+POE::Session->create(
+ inline_states => {
+ _start => sub {
+ ImmutableFoo->new();
+ },
+ _child => sub {
+ push( @reason, $_[ARG0] );
+ push( @retval, $_[ARG2] );
+ },
+ }
+);
+
+$poe_kernel->run;
+
+is( scalar(@reason), 2, "called two times" );
+
+is_deeply( $reason[0], 'create', "CHILD create was called" );
+is_deeply( $reason[1], 'lose', "CHILD lose was called" );
+is_deeply( $retval[0], 'create', "START return value is correct" );
+is_deeply( $retval[1], 'lose', "STOP return value is correct" );
+}
+done_testing;